All Databases Inside Mac - Basic Toolbox

HiliteControl

Make control active/inactive; highlight/dim a part

#include <Controls.h> Control Manager

void HiliteControl( theControl, hiliteCode );

ControlHandle theControl ; handle of control to modify

short hiliteCode ; 0=active; 255=inactive; 1...253=part code

HiliteControl changes the active/inactive status of a control OR it

highlights a specific part of a control.

theControl is a handle leading to a variable-length ControlRecord structure. It

identifies the control you wish to update.

hiliteCode specifies the action to take. It must range from 0 to 255 with the

following options:

0 theControl is active and is not highlighted

1 to 253 A "part code" as defined by the control definition function.

This part will be redrawn highlighted. See Notes.

254 ( reserved, don't use)

255 theControl becomes inactive and is dimmed

Returns: none

Notes: An "inactive" control is one whose contrlHilite field is 255. Using

HiliteControl( theControl, 255) causes the control to be dimmed. If the

user attempts to select an inactive control, FindControl will return a part

code of 0 (none).

Active Controls Inactive Controls Active and Hilited

Normally, HiliteControl is used only for making a control active or

inactive. Since TrackControl automatically handles control highlighting,

hiliteCodes of 1 through 253 are rarely needed (a possible exception is if

you have created a custom control - see Custom Controls). Incidentally,

to put the "X" in a check box (or the "•" in a radio button), use

SetCtlValue.

When a color control is hilited, the colors specified with the cFrameColor

and the cBodyColor identifiers are swapped.

If you wish to highlight a part of a standard control manually, you may set

hiliteCode to one of the named constants found in Controls.h:

inButton (10) Invert the entire  button
inCheckBox (11) Widen lines of the check box or radio  button
inUpButton (20) Black-fill up (or left) arrow in scroll bar
inDownButton (21) Black-fill down (or right) arrow in scroll bar
inThumb (129) Hide lines of the thumb rectangle of a scroll bar